Cream of the Crop 12

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / SRTDS32A.ZIP / RUNTIME.DOC < prev next >

Wrap

Text File | 1996-03-06 | 22.0 KB | 618 lines

The following documentation applies to any program written in Clarion 3.0. It has been included for your reference. ════════════════════════════════════════════════════════════════════════════════ Runtime Configuration Switches ════════════════════════════════════════════════════════════════════════════════ At runtime, during the initial load of your Clarion program the program will search the current directory for a file named "Program.ini", where "Program" is the name of the executable file. This file contains environment variables which can specify some of the runtime characteristics of your program. The Clarion install creates a subdirectory 'OPTIONS' which contains the Clarion source code, a project file, and a dynalinked OPTIONS.EXE. Most of these environment switches may be set by the OPTIONS.EXE, or you may manually create an ascii text file with the settings you wish to override. You may also initialize these configuration variables at the DOS prompt using the DOS SET command. Your program can use the COMMAND() statement to read the value of any of these switches. (see the Language Reference manual for details) The following is a list of the environment switches with a description of each variable. If the switch has a default value it is also noted. Override .INI filename ─────────────────────── CLAINI: specifies a configuration file that will be used in place of "Program.ini". This switch may only be specified on the command line of your program. usage: Program.exe CLAINI=Drive:\Path\ConfigurationFile.ini where ConfigurationFile.ini is replaced with the name of the configuration file you wish to use. example: Myprog.exe CLAINI=C:\Config\Other.ini Video Mode, Screen Objects and Mouse switches ────────────────────────────────────────────── CLASMOOTH: specifies whether your program uses the smooth mouse movement used in the Clarion environment. If set to OFF the mouse will move a full character for each mouse movement. usage: CLASMOOTH=ON [ use smooth mouse ] CLASMOOTH=OFF [ don't use smooth mouse ] default:CLASMOOTH=ON ────────────────────────────────────────────────────────────────────────── CLAFONTS: specifies whether your program remaps ascii characters for checkboxes, radio buttons, and the mouse cursor. If CLAFONTS is ON your program uses an arrow mouse cursor, square check boxes, and circular radio buttons. This causes replacements of some standard ASCII characters with the arrow, square, and circle characters. Your program must issue the LOADSYMBOLS() statement in order to activate the graphic style replacements. (see LOADSYMBOLS in the Language Reference for more details). usage: CLAFONTS=ON CLAFONTS=OFF default:CLAFONTS=ON ────────────────────────────────────────────────────────────────────────── CLABORDERS: specifies a list of ascii characters that are remapped to achieve display of thin borders. Thin borders are only available in 25 line VGA mode. Your program can read this switch and then issue the LOADBORDER() statement with the string specified by CLABORDER. Use the COMMAND() statement to return the value of the switch. (see LOADBORDER and COMMAND() in the Late Breaking News manual for details) usage: CLABORDERS='#,#,#,#,#' where # is replaced with an ascii value that will be modified at runtime. ────────────────────────────────────────────────────────────────────────── CLAGRAPH: specifies the initial graphics mode of your program. usage: CLAGRAPH=VideoMode where VideoMode may equal: ALLTEXT [ 25/80 text mode ] EGA [ standard Ega ] VGA [ standard Vga ] SVGA256 [ 256 color Super Vga ] ALLGRAPH [ Stay in Graphics mode, only use this setting if your program has a GRAPHIC attribute ] usage: CLAGRAPH=ALLTEXT ────────────────────────────────────────────────────────────────────────── CLAMRESET: specifies whether the mouse is sent a hardware reset. Useful for certain incompatible mouse drivers. When set ON the mouse is initialized with a hardware reset. usage: CLAMRESET=ON ────────────────────────────────────────────────────────────────────────── CLASCROLL: specifies an alternate scrolling method used on a virtual screen with a scrolling field. When set to 1 the alternate scroll is used. usage: CLASCROLL=1 ────────────────────────────────────────────────────────────────────────── CLAVSCREEN: specifies that a program uses functions which write directly to the video screen buffer. When set to ON direct screen writes will be added to the virtual screen buffer. If OFF direct screen writes will not be added to the virtual screen buffer, and will not appear on screen after being scrolled off the view area. This switch only applies to virtual screens. usage: CLAVSCREEN=ON default: CLAVSCREEN=OFF ────────────────────────────────────────────────────────────────────────── CLASYMBOLS: specifies which ascii characters your program remaps for graphic style checkboxes, radio buttons, and the arrow mouse cursor. Your program must read this switch and then issue the LOADSYMBOLS() statement with the string specified by CLASYMBOLS. The COMMAND() statement can be used to read the value of the switch. usage: CLASYMBOLS='#,#,#,#,#,#,#,#,#,#,#,#,#' where # is replaced with an ascii value that will be modified at runtime. Country Dependent Information ────────────────────────────── CLACOLSEQ1: specifies an alternate collating sequence. The total number of characters specified must be exactly (223 characters). If the length is incorrect, the standard collating sequence will be used. The string may be split into two switches; CLACOLSEQ1 and CLACOLSEQ2. Using the two switches may make viewing the strings in an editor somewhat easier. The collating sequence specified will be used for building Key and Index files, as well as for sorted Queues. The sort order for a space character (Ascii 32) cannot be changed, it must be the first character in the string. usage: CLACOLSEQ1="AsciiString" [CLACOLSEQ2]="AsciiString" example: CLACOLSEQ1=" !""#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ÇüéâäàåçêëèïîìÄ" CLACOLSEQ2="ÅÉæÆôöòûùÿÖÜ¢£¥₧ƒáíóúñÑªº¿⌐¬½¼¡«»░▒▓│┤╡╢╖╕╣║╗╝╜╛┐└┴┬├─┼╞╟╚╔╩╦╠═╬╧╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀αßΓπΣσµτΦΘΩδ∞φε∩≡±≥≤⌠⌡÷≈°∙·√ⁿ²■" ────────────────────────────────────────────────────────────────────────── CLAMONTH: specifies the text to be returned by functions and picture formats involving the month full name. usage: CLAMONTH="Month1","Month2", ......... example: CLAMONTH="January","February","March","April","May","June","July","August","September","October","November","December" ────────────────────────────────────────────────────────────────────────── CLAMON: specifies the text to be returned by functions and picture formats involving the abbreviated month name. usage: CLAMON="AbbreviatedMonth1","AbbreviatedMonth2", ........ example: CLAMON="Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec" ────────────────────────────────────────────────────────────────────────── CLAAMPM: specifies the text returned by functions and picture formats for AM and PM indicators. usage: CLAAMPM="AM","PM" ────────────────────────────────────────────────────────────────────────── CLACASE: specifies a two dimensional array of characters. The first dimension contains a list of the UPPERCASE version of the characters. The second dimension specifies the lower case version of the corresponding array element. The length of the two dimensions must be equal. usage: CLACASE="string","string" example: CLACASE="ABCDEFGHIJKLMNOPQRSTUVWXYZ","abcdefghijklmnopqrstuvwxyz" ────────────────────────────────────────────────────────────────────────── Virtual Memory settings ──────────────────────── CLAVM: specifies virtual memory configuration. usage: see Language Reference Manual appendix C for details. New options not in the manual are: CLAVM=EMS/2,.,32,3,4 [use half of available EMS] CLAVM=EMS/3,.,32,3,4 [use a third of available EMS] CLAVM=XMS/2,.,32,3,4 [use half of available XMS] CLAVM=XMS/3,.,32,3,4 [use a third of available XMS] example: CLAVM=EMS-64,.,32,3,4 Stop Window Information ─────────────────────── CLASTOP: specify the Hotkey for calling the STOP() function, followed by ON or OFF. The second parameter (ON or OFF) determines whether system level information is available in the STOP() window. usage: CLASTOP=1085,ON [use ALT= key, display system information] usage: CLASTOP=1085,OFF [use ALT= key, don't display system information] usage: CLASTOP=OFF [do not make STOP available] Printer Control ───────────────────── CLAPRINTER: specify the printer control file used by REPORT structures. usage: CLAPRINTER=driveletter:\path\printercontrol.ctl example: CLAPRINTER=c:\config\LASER.CTL ────────────────────────────────────────────────────────────────────────── CLAPRINTDEVICE: specify printer parameters. Can be set thru the Clarion environment Printer Setup (AltF,AltT). The first parameter, the DEVICENAME is used by the PRINT() statement at runtime. All other parameters are ignored at runtime, however they are used by the Clarion environment. usage: CLAPRINTDEVICE=DosDevice,LinesPerPage,ColsPerLine, PrintLineNumbers,PrintPageNumbers,FormFeedAfter, ControlBefore,ControlAfter example: CLAPRINTDEVICE=COM1,59,80,ON,ON,ON,'<27,54>','<27,56>' DOSDevice may contain any valid DOS device name, including a valid DOS filename. General Environment ──────────────────── CLABREAK: specifies whether Ctrl-Break will cause program termination. usage: CLABREAK=ON CLABREAK=OFF ────────────────────────────────────────────────────────────────────────── CLATMP: specifies a directory where temporary files will be written. usage: CLATMP=Drive:\Path example: CLATMP=C:\temp ────────────────────────────────────────────────────────────────────────── CLARUNFLUSH: specifies whether a RUN(command) will swap extended memory to disk. This is only applicable for Extended Memory models (extended and extended w/runtime libs). usage: CLARUNFLUSH=ON CLARUNFLUSH=OFF ────────────────────────────────────────────────────────────────────────── CLAKEYS: used for compatibility for IBM 83 or 84 keyboards (XT style). usage: CLAKEYS=IBM83/84 ────────────────────────────────────────────────────────────────────────── CLAMEMTRAP: Specifies whether a Halt window is displayed when one of the following conditions occur: Stack Overflow. Array index out of range. Function is called with a missing parameter. usage: CLAMEMTRAP = ON : CLAMEMTRAP = OFF ────────────────────────────────────────────────────────────────────────── CLAMATHTRAP: Specifies whether Floating Point Exceptions are reported. Floating Point Exceptions Include: Divide By Zero Overflow / Underflow Errors CLAMATHTRAP=ON will trap all FP Exceptions CLAMATHTRAP=OFF will NOT trap FP Exceptions usage: CLAMEMTRAP = ON (Default) : CLAMEMTRAP = OFF ════════════════════════════════════════════════════════════════════════════════ Typical System Requirements ════════════════════════════════════════════════════════════════════════════════ Minimum Requirements 1. 8088 based computer or higher 2. MS/PC-DOS Version 3.3 or higher. 3. Monochrome 80x25 monitor. 4. 400K RAM. 5. Memory manager None. 6. 1Meg of free disk. (to handle memory overflow, temp files etc.) Practical Requirements 1. 80286 based computer or higher 2. MS/PC-DOS Version 3.3 or higher. 3. EGA 4. 2Meg RAM. 5. Memory manager None. EMS,XMS,DISK supported. VCPI,DPMI support in extender. 6. 6Meg of free disk. (to handle memory overflow, temp files etc.) ════════════════════════════════════════════════════════════════════════════════ Memory Manager Example Settings: ════════════════════════════════════════════════════════════════════════════════ ********************************************************************** IMPORTANT NOTE! These are only EXAMPLE configurations for these Memory Managers. ALL Memory Manager switches are HARDWARE DEPENDENT. Your settings will most likely differ from those shown below. If you are unsure of the settings you should use, run the appropriate configuration program for your memory manager. Memory Mgr. Configure with ───────────────────────────────── QEMM OPTIMIZE 386MAX MAXIMIZE MS DOS 6 MEMMAKER PC DOS 6 RAMSETUP ********************************************************************** MS DOS 6 / EMM386 - CONFIG.SYS DEVICE=C:\DOS\HIMEM.SYS DEVICE=C:\DOS\EMM386.EXE RAM HIGHSCAN X=D000-D1FF BUFFERS=15,0 FILES=60 DOS=UMB LASTDRIVE=E FCBS=4,0 DEVICE = C:\hyp\hyperdkx.EXE c:1024 cw:1024 h v DEVICEHIGH /L:1,12048 =C:\DOS\SETVER.EXE DOS=HIGH SHELL=C:\DOS\COMMAND.COM C:\DOS\ /p *Alternate EMM386 CONFIG.SYS settings under DOS 6 DEVICE=C:\DOS\EMM386.EXE noems X=D000-D1FF MS DOS 6 / EMM386 - AUTOEXEC.BAT @ECHO OFF PROMPT $p$g PATH C:\DOS;c:\clarion3;c:\cmd;c:\norton loadhigh doskey SET TEMP=C:\DOS ---------------------------------------------------------------------- PC DOS 6.1 / EMM386 - CONFIG.SYS ***** NOTE: If you do not have the most recent version of IBM DOS 6 you may have problems running CDD. The fix for IBMDOS.COM is on the latest disk compression diskette (if your version did not come w/ disk compression) or available for download from the Clarion Forum on CompuServe (Go Clarion) in Library 8. DEVICE=C:\DOS\HIMEM.SYS DEVICE=C:\DOS\EMM386.EXE NOEMS RAM X=A000-B1FF I=B200-B7FF X=B800-C7FF I=C800-CFFF X=D000-D3FF I=D400-EFFF X=F000-F7FF H=64 A=7 D=32 DEVICE=C:\DOS\RAMBOOST.EXE LOAD DOS=HIGH DEVICE=C:\DOS\SETVER.EXE FILES=50 BUFFERS=20 DEVICE=C:\HYPERDKX.EXE C:640 CW:512 H OR SHELL=C:\DOS\COMMAND.COM C:\DOS\ /p STACKS=0,0 PC DOS 6.1 / EMM386 - AUTOEXEC.BAT @ECHO OFF SET CLATMP=C:\TEMP SET TEMP=C:\TEMP SET IBMAV=C:\DOS CALL C:\DOS\IBMAVDR.BAT C:\DOS\ PROMPT $_$t$_$p$g PATH C:\DOS;C:\;C:\CMD;C:\CLARION3;C:\CDDW\BIN;C:\NU;C:\CLARION;C:\WINDOWS Rem --- Check for lost clusters or chains CHKDSK /F Rem --- Delete any Temp Files left over DEL C:\TEMP\*.$$$ Rem --- Load Doskey C:\DOS\DOSKEY Rem --- Load Mouse C:\DOS\MOUSE Rem --- Load Network Drivers IPX NET5.COM ---------------------------------------------------------------------- MS DOS 5 / EMM386 - CONFIG.SYS DEVICE=C:\DOS\HIMEM.SYS DEVICE=C:\DOS\EMM386.EXE NOEMS I=E000-EFFF DOS=HIGH,UMB SHELL=C:\DOS\COMMAND.COM C:\DOS\ /P /E:186 FILES=50 BUFFERS=5 STACKS=0,0 BREAK=ON Note : Address location E000-EFFF is machine dependent. This memory location may increase your conventional memory by +30K. MS DOS 5 / EMM386 - AUTOEXEC.BAT PROMPT $p$g PATH C:\;C:\CLARION3;C:\DOS Rem Rem In the next statement AUTO switch enables protected mode access Rem EMM386 AUTO LH BTRIEVE /E /M:48 /P:4096 /T:\CLARION3\CLARION.TRN LH MOUSE LH DOSKEY ---------------------------------------------------------------------- 386/MAX - CONFIG.SYS DOS=HIGH FILES=50 Several CONFIG.SYS variations: DEVICE=C:\386max\386max.sys pro=c:\386max\386max.pro DEVICE=C:\386max\386max.sys pro=c:\386max\386max.pro NODPMI DEVICE=C:\386MAX\386load.sys size=12576 flexframe prog=C:\HYPERKEY.EXE DEVICE=C:\386MAX\386load.sys size=45360 flexframe prog=C:\HYPERDKX.EXE C:1024 H DEVICE=C:\386MAX\386load.sys size=9040 flexframe prog=C:\DOS\ANSI.SYS SHELL=C:\DOS\COMMAND.COM C:\DOS\ /E:186 /p STACKS=0,0 386/MAX - AUTOEXEC.BAT PROMPT = $P$G PATH C:\;C:\CLARION3;C:\DOS C:\386MAX\386load size=6400 flexframe prog=DOSKEY C:\386MAX\386load size=10736 prgreg=2 flexframe prog=MOUSE /2 ---------------------------------------------------------------------- QEMM386 - CONFIG.SYS DEVICE=C:\QEMM\QEMM386.SYS R:5 X=B000-B0FF X=C600-C7FF DBF=2 ST:M RAM DOS=HIGH DEVICE=C:\QEMM\LOADHI.SYS /R:2 C:\DOS\ANSI.SYS DEVICE=C:\QEMM\LOADHI.SYS /R:1 C:\MOUSE.SYS SHELL=C:\DOS\COMMAND.COM /E:500 /P BUFFERS=20 FILES=70 QEMM386 - AUTOEXEC.BAT PROMPT $P$G PATH C:\;C:\CLARION3;C:\DOS;C:\QEMM C:\QEMM\LOADHI /R:3 /RES=4336 /SQT=D000-D0FF \DOS\DOSKEY C:\QEMM\LOADHI /R:2 LSL C:\QEMM\LOADHI /R:4 TRXNET C:\QEMM\LOADHI /R:2 /RES=16096 /SQT=C600-C7FF IPXODI C:\QEMM\LOADHI /R:4 NETX QEMM386 - CONFIG.SYS DEVICE=C:\QEMM\QEMM386.SYS R:5 X=B000-B0FF X=C600-C7FF DBF=2 ST:M RAM DOS=HIGH DEVICE=C:\QEMM\LOADHI.SYS /R:2 C:\DOS\ANSI.SYS DEVICE=C:\QEMM\LOADHI.SYS /R:1 C:\MOUSE.SYS SHELL=C:\DOS\COMMAND.COM /E:500 /P BUFFERS=20 FILES=70 ════════════════════════════════════════════════════════════════════════════════ ADDITIONAL RUNTIME ERRORS IN THE CLARION ENVIRONMENT ════════════════════════════════════════════════════════════════════════════════ File ERRORINF.$$$ has the format: SSSS:OOOO ERRORCODE where SSSS = code segment, OOOO = IP value and ERRORCODE = Hex error code. IF SSSS:OOOO = ????:???? the error is from the loader. Run-time Codes: 01H Stack overflow Description: The application is running out of stack, raise the stack setting on the Project/Debug window and remake the application. The STOP window can be checked before entering the module that fails to see how much stack is available. You should try to have at least 4k of stack available. 02H Null pointer de-reference Description: The application Project is set for Null Parameter Checking and if the procedure that fails contains a SCREEN or REPORT that has a USE(MEMO) you must turn OFF Null Parameter Checking for that module. Null Parameter Checking is set on the Project/Debug window. 03H Termination caused by signal. (User break or Floating point exception) Description: Generally means you have referenced an uninitialized or invalid floating point number. 04H Math Overflow. Description: Generally means you have referenced an uninitialized or invalid floating point number. 05H Range. 06H No Return. 07H No matching Case Label. 08H Long Integer Divide By Zero. 09H Index Error. Description: An array subscript is not within a valid range. 0AH Pure Virtual Function Called. Overlay Loader Errors: 101H Invalid Export Entry In Exe File/DLL. 102H Too many modules. 103H DLL is incorrect version. 104H Module is corrupt. 105H BP chain corrupt. 106H Module not found. 107H Incorrect fixup type. 108H EMS error. 109H Module not corrcet format. 10AH Invalid function request to loader. 10BH Module initialization failed. 10CH File not found. 10DH Out of memory 10EH I/O error on read. 10FH I/O error on seek. 110H Stack overflow. 111H Illegal reference to code segment. 112H Segment list corrupt. 113H Too many segments. 114H Attempt to reload segment. ════════════════════════════════════════════════════════════════════════════════ REPORTING BUGS ════════════════════════════════════════════════════════════════════════════════ Software Product Report Name : Company : Area code and Phone : FAX number : Registration# : Version : (To obtain the current version number choose "HELP" from the main menu, then choose "About".) Description of Bug : Steps to reproduce the problem (please explain step by step): Work-around: Reproducible: <Always> <Random> <Never> <Didn't try> Severity Level: < > 1. System locks, crashes, or file corruption occurs < > 2. Does not operate as documented < > 3. Cosmetic or user interface problem < > 4. Suggestion or documentation error Machine Configuration - Computer Brand and Model : System BIOS : CPU type and speed : Total Memory : Operating System & Version : Memory Manager : Disk Cache : Network O/S : Video Card :